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CONFIDENTIAL and PROPRIETARY 


This document describes the V 0.9 release of the Handy development environment. It includes 
these sections: 

• MUTE the Music 

• Other 6502: Changes 

• HandyAsml.08 

• What You Must Do To Start Using This Release 


MUTE the Music 

If you would like to mute the playing of music without pausing the song, define MUTE_USER and 
then use the new MUTE music macro. 

The MUTE macro acts as a toggle. You can detect whether music is currently muted by examining 
the Mute_flag field. If the field is non-zero, the music is currently muted. 

The INITHMUSIC call causes music to become rxjn-muted. 


Other 6502: Changes 

The GETSWITCH and GETJOY macros no Icnger perform the AUTO_TIMEOUT reset functions. 
This logic has been moved to the TIMEOUT macro defined in display.src. Also, the SWITCHES- 
reading logic has been corrected to test expbdtly for the PAUSE_SWITCH bit. 

The old cart.src didn’t get distributed just before CES. Now it's distributed. An invalid LDA lODAT 
now reads LDA lODAT RAM. 


The auto-timeout constant is adjusted to cause timeout to happen in 1 hour rather than 1 5 hours 
(when external power is present). 

END_2PAGE macro now warns you if your allocations go out of zero-page. 


HandyAsm 1.08 Macros 


Macros now can refer to their arguments by value as well as by name. The format for reference to 
argument by value is ?%FN where %F stands for a format argument (%d equals decimal, %x for 
hexidecimal. %c for character); the N stands for the usual macro argument number. 

For example, consider the new macro ECHO_VALUE (defined in sys.mac): 

#MACRO ECHO_VALUE 

.ECHO "Value of ?0 is ?%d0 ($?%x0) 

#ENDMACRO 
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